<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="utf-8">
        <meta http-equiv="X-UA-Compatible" content="IE=edge">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        
        
        
        <link rel="shortcut icon" href="../../img/favicon.ico">
        <title>PDA - Mall Docs</title>
        <link href="../../css/bootstrap-custom.min.css" rel="stylesheet">
        <link href="../../css/font-awesome.min.css" rel="stylesheet">
        <link href="../../css/base.css" rel="stylesheet">
        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/github.min.css">
        <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
        <!--[if lt IE 9]>
            <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
            <script src="https://oss.maxcdn.com/libs/respond.js/1.4.2/respond.min.js"></script>
        <![endif]-->

        <script src="../../js/jquery-1.10.2.min.js" defer></script>
        <script src="../../js/bootstrap-3.0.3.min.js" defer></script>
        <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
        <script>hljs.initHighlightingOnLoad();</script> 
    </head>

    <body>

        <div class="navbar navbar-default navbar-fixed-top" role="navigation">
            <div class="container">

                <!-- Collapsed navigation -->
                <div class="navbar-header">
                    <!-- Expander button -->
                    <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
                        <span class="sr-only">Toggle navigation</span>
                        <span class="icon-bar"></span>
                        <span class="icon-bar"></span>
                        <span class="icon-bar"></span>
                    </button>
                    <a class="navbar-brand" href="../..">Mall Docs</a>
                </div>

                <!-- Expanded navigation -->
                <div class="navbar-collapse collapse">
                        <!-- Main navigation -->
                        <ul class="nav navbar-nav">
                            <li >
                                <a href="../..">Home</a>
                            </li>
                            <li class="dropdown">
                                <a href="#" class="dropdown-toggle" data-toggle="dropdown">User <b class="caret"></b></a>
                                <ul class="dropdown-menu">
                                    
<li >
    <a href="../../user/user/">Main</a>
</li>
                                </ul>
                            </li>
                            <li class="dropdown">
                                <a href="#" class="dropdown-toggle" data-toggle="dropdown">Mall <b class="caret"></b></a>
                                <ul class="dropdown-menu">
                                    
<li >
    <a href="../../mall/">首页</a>
</li>
                                    
<li >
    <a href="../../mall/catalog/">分类</a>
</li>
                                    
<li >
    <a href="../../mall/coupon/">优惠券</a>
</li>
                                    
<li >
    <a href="../../mall/goods/">产品</a>
</li>
                                    
<li >
    <a href="../../mall/search/">搜索</a>
</li>
                                    
<li >
    <a href="../../mall/cart/">购物车</a>
</li>
                                    
<li >
    <a href="../../mall/address/">地址</a>
</li>
                                    
<li >
    <a href="../../mall/activity/">活动</a>
</li>
                                    
<li >
    <a href="../../mall/order/">订单</a>
</li>
                                    
<li >
    <a href="../../mall/my/">个人中心</a>
</li>
                                    
<li >
    <a href="../../mall/collect/">收藏</a>
</li>
                                    
<li >
    <a href="../../mall/aftersale/">售后</a>
</li>
                                    
<li >
    <a href="../../mall/vip/">会员</a>
</li>
                                    
<li >
    <a href="../../mall/charge/">充值</a>
</li>
                                    
<li >
    <a href="../../mall/live/">直播</a>
</li>
                                    
<li >
    <a href="../../www/www/">官网</a>
</li>
                                    
<li >
    <a href="../../mall/invite/">邀请</a>
</li>
                                    
<li >
    <a href="../../feed/feed/">圈子</a>
</li>
                                </ul>
                            </li>
                            <li class="dropdown">
                                <a href="#" class="dropdown-toggle" data-toggle="dropdown">管理后台 <b class="caret"></b></a>
                                <ul class="dropdown-menu">
                                    
<li >
    <a href="../../admin/user/">用户</a>
</li>
                                    
<li >
    <a href="../../admin/goods/">商品</a>
</li>
                                    
<li >
    <a href="../../admin/ad/">推广</a>
</li>
                                    
<li >
    <a href="../../admin/topic/">活动</a>
</li>
                                    
<li >
    <a href="../../www/www-admin/">官网</a>
</li>
                                </ul>
                            </li>
                            <li class="dropdown active">
                                <a href="#" class="dropdown-toggle" data-toggle="dropdown">溯源 <b class="caret"></b></a>
                                <ul class="dropdown-menu">
                                    
<li class="active">
    <a href="./">PDA</a>
</li>
                                </ul>
                            </li>
                            <li class="dropdown">
                                <a href="#" class="dropdown-toggle" data-toggle="dropdown">中优 <b class="caret"></b></a>
                                <ul class="dropdown-menu">
                                    
<li >
    <a href="../../zhongyou/trading_index/">指数</a>
</li>
                                    
<li >
    <a href="../../zhongyou/admin/">后台</a>
</li>
                                </ul>
                            </li>
                            <li class="dropdown">
                                <a href="#" class="dropdown-toggle" data-toggle="dropdown">快递 <b class="caret"></b></a>
                                <ul class="dropdown-menu">
                                    
<li >
    <a href="../../express/express/">app接口</a>
</li>
                                    
<li >
    <a href="../../express/express_user/">用户app接口</a>
</li>
                                    
<li >
    <a href="../../admin/express/">管理接口</a>
</li>
                                </ul>
                            </li>
                        </ul>

                    <ul class="nav navbar-nav navbar-right">
                        <li>
                            <a href="#" data-toggle="modal" data-target="#mkdocs_search_modal">
                                <i class="fa fa-search"></i> Search
                            </a>
                        </li>
                            <li >
                                <a rel="next" href="../../www/www-admin/">
                                    <i class="fa fa-arrow-left"></i> Previous
                                </a>
                            </li>
                            <li >
                                <a rel="prev" href="../../zhongyou/trading_index/">
                                    Next <i class="fa fa-arrow-right"></i>
                                </a>
                            </li>
                    </ul>
                </div>
            </div>
        </div>

        <div class="container">
                <div class="col-md-3"><div class="bs-sidebar hidden-print affix well" role="complementary">
    <ul class="nav bs-sidenav">
        <li class="main active"><a href="#pda">PDA相关接口</a></li>
            <li><a href="#_1">修订记录</a></li>
            <li><a href="#_2">背景</a></li>
            <li><a href="#_3">产品说明</a></li>
            <li><a href="#_4">关键流程说明</a></li>
            <li><a href="#_5">接口说明</a></li>
    </ul>
</div></div>
                <div class="col-md-9" role="main">

<h1 id="pda">PDA相关接口</h1>
<div class="toc">
<ul>
<li><a href="#pda">PDA相关接口</a><ul>
<li><a href="#_1">修订记录</a></li>
<li><a href="#_2">背景</a></li>
<li><a href="#_3">产品说明</a></li>
<li><a href="#_4">关键流程说明</a></li>
<li><a href="#_5">接口说明</a><ul>
<li><a href="#_6">登录头说明</a></li>
<li><a href="#_7">手机号登录</a></li>
<li><a href="#10">1.0 手机号密码登陆</a><ul>
<li><a href="#_8">接口说明</a></li>
<li><a href="#_9">请求说明</a></li>
<li><a href="#_10">输入参数</a></li>
<li><a href="#_11">错误说明</a></li>
<li><a href="#_12">返回实例</a></li>
</ul>
</li>
<li><a href="#111-token">1.1.1 刷新token</a><ul>
<li><a href="#_13">接口说明</a></li>
<li><a href="#_14">请求说明</a></li>
<li><a href="#_15">输入参数</a></li>
<li><a href="#_16">错误说明</a></li>
<li><a href="#_17">返回实例</a></li>
</ul>
</li>
<li><a href="#11">1.1 查询接口</a><ul>
<li><a href="#_18">接口说明</a></li>
<li><a href="#_19">请求说明</a></li>
<li><a href="#_20">输入参数</a></li>
<li><a href="#_21">错误说明</a></li>
<li><a href="#_22">返回实例</a></li>
</ul>
</li>
<li><a href="#12">1.2 获取产品列表信息</a><ul>
<li><a href="#_23">接口说明</a></li>
<li><a href="#_24">请求说明</a></li>
<li><a href="#_25">输入参数</a></li>
<li><a href="#_26">错误说明</a></li>
<li><a href="#_27">返回实例</a></li>
</ul>
</li>
<li><a href="#13">1.3 添加批次信息</a><ul>
<li><a href="#_28">接口说明</a></li>
<li><a href="#_29">请求说明</a></li>
<li><a href="#_30">输入参数</a></li>
<li><a href="#_31">错误说明</a></li>
<li><a href="#_32">返回实例</a></li>
</ul>
</li>
<li><a href="#14">1.4  仓库/经销商 列表</a><ul>
<li><a href="#_33">接口说明</a></li>
<li><a href="#_34">请求说明</a></li>
<li><a href="#_35">输入参数</a></li>
<li><a href="#_36">错误说明</a></li>
<li><a href="#_37">返回实例</a></li>
</ul>
</li>
<li><a href="#141">1.4.1  城市列表</a><ul>
<li><a href="#_38">接口说明</a></li>
<li><a href="#_39">请求说明</a></li>
<li><a href="#_40">输入参数</a></li>
<li><a href="#_41">错误说明</a></li>
<li><a href="#_42">返回实例</a></li>
</ul>
</li>
<li><a href="#15">1.5  入库接口</a><ul>
<li><a href="#_43">接口说明</a></li>
<li><a href="#_44">请求说明</a></li>
<li><a href="#_45">输入参数</a></li>
<li><a href="#_46">案例</a></li>
<li><a href="#_47">错误说明</a></li>
<li><a href="#_48">返回实例</a></li>
</ul>
</li>
<li><a href="#16">1.6  出库接口</a><ul>
<li><a href="#_49">接口说明</a></li>
<li><a href="#_50">请求说明</a></li>
<li><a href="#_51">输入参数</a></li>
<li><a href="#_52">案例</a></li>
<li><a href="#_53">错误说明</a></li>
<li><a href="#_54">返回实例</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<h2 id="_1">修订记录</h2>
<hr />
<table>
<thead>
<tr>
<th>日期</th>
<th>作者</th>
<th>修订类型</th>
<th>修订内容</th>
<th>版本</th>
</tr>
</thead>
<tbody>
<tr>
<td>2020年07月03日</td>
<td>冷立纲</td>
<td>A</td>
<td>新增设计方案</td>
<td>1.0</td>
</tr>
</tbody>
</table>
<blockquote>
<p>【修订类型：A-新增  M-修改 D-删除】</p>
</blockquote>
<h2 id="_2">背景</h2>
<p>PDA 出入库管理接口</p>
<h2 id="_3">产品说明</h2>
<h2 id="_4">关键流程说明</h2>
<h2 id="_5">接口说明</h2>
<h4 id="_6">登录头说明</h4>
<p><em>将accessToken作为请求头 Authorization: 'token'  发送请求即可获取权限</em></p>
<h4 id="_7">手机号登录</h4>
<ol>
<li>手机号密码登陆 /trace/employee/login</li>
<li>将accessToken作为请求头 Authorization: 'token'  发送请求</li>
</ol>
<h4 id="10">1.0 手机号密码登陆</h4>
<h5 id="_8">接口说明</h5>
<p>后台添加企业员工，根据手机号和密码可以登陆</p>
<h5 id="_9">请求说明</h5>
<table>
<thead>
<tr>
<th align="left">http 请求方式</th>
<th align="center">post</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">url</td>
<td align="center">/trace/employee/login</td>
</tr>
</tbody>
</table>
<h5 id="_10">输入参数</h5>
<table>
<thead>
<tr>
<th align="left">参数</th>
<th align="center">必选</th>
<th align="left">类型</th>
<th align="left">参数说明</th>
<th align="left">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">mobile</td>
<td align="center">是</td>
<td align="left">string</td>
<td align="left">手机号</td>
<td align="left"></td>
</tr>
<tr>
<td align="left">deviceId</td>
<td align="center">是</td>
<td align="left">设备号</td>
<td align="left">手机imei</td>
<td align="left"></td>
</tr>
<tr>
<td align="left">password</td>
<td align="center">是</td>
<td align="left">密码</td>
<td align="left">密码</td>
<td align="left"></td>
</tr>
</tbody>
</table>
<h5 id="_11">错误说明</h5>
<h5 id="_12">返回实例</h5>
<pre><code class="json">
    {
    &quot;c&quot;: 0,
    &quot;m&quot;: null,
    &quot;d&quot;: {
        &quot;id&quot;: 2,  //员工ID
        &quot;enterpriseId&quot;: &quot;8a2a41fa75d42fc50176643762630025&quot;, //所属企业ID
        &quot;name&quot;: &quot;张三&quot;, //员工名称
        &quot;employeeRole&quot;: 1, //员工角色  1 出库 2 入库  3 全部
        &quot;accessToken&quot;: &quot;eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOlsiMiIsIkExNTIwMTAwODk2MSJdLCJleHAiOjE2MTQ1MjUzNzN9.ye4Hz3aDGuSr4OGYe3uR-oe5YLaypQ9YUfNC4boIjBo&quot;,
        &quot;accessExpiresIn&quot;: 1614525373964, //过期时间
        &quot;refreshToken&quot;: &quot;jRXTmvWiToGbjkb&quot;, //刷新token
        &quot;refreshExpiresIn&quot;: 1619622973964 // 刷新token 过期时间
    }
}

</code></pre>

<h4 id="111-token">1.1.1 刷新token</h4>
<h5 id="_13">接口说明</h5>
<p>刷新token</p>
<h5 id="_14">请求说明</h5>
<table>
<thead>
<tr>
<th align="left">http 请求方式</th>
<th align="center">post</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">url</td>
<td align="center">/trace/employee/token/refresh</td>
</tr>
</tbody>
</table>
<h5 id="_15">输入参数</h5>
<table>
<thead>
<tr>
<th align="left">参数</th>
<th align="center">必选</th>
<th align="left">类型</th>
<th align="left">参数说明</th>
<th align="left">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">refreshToken</td>
<td align="center">是</td>
<td align="left">string</td>
<td align="left">刷新token</td>
<td align="left"></td>
</tr>
</tbody>
</table>
<h5 id="_16">错误说明</h5>
<h5 id="_17">返回实例</h5>
<pre><code class="json">
    {
    &quot;c&quot;: 0,
    &quot;m&quot;: null,
    &quot;d&quot;: {
        &quot;accessToken&quot;: &quot;eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOlsiMiIsIkExNTIwMTAwODk2MSJdLCJleHAiOjE2MTQ1MjUzNzN9.ye4Hz3aDGuSr4OGYe3uR-oe5YLaypQ9YUfNC4boIjBo&quot;,
        &quot;accessExpiresIn&quot;: 1614525373964, //过期时间
        &quot;refreshToken&quot;: &quot;jRXTmvWiToGbjkb&quot;, //刷新token
        &quot;refreshExpiresIn&quot;: 1619622973964 // 刷新token 过期时间
    }
}

</code></pre>

<h4 id="11">1.1 查询接口</h4>
<h5 id="_18">接口说明</h5>
<p>根据扫码信息回显产品信息</p>
<h5 id="_19">请求说明</h5>
<table>
<thead>
<tr>
<th align="left">http 请求方式</th>
<th align="center">get</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">url</td>
<td align="center">/trace/barcode/get</td>
</tr>
</tbody>
</table>
<h5 id="_20">输入参数</h5>
<table>
<thead>
<tr>
<th align="left">参数</th>
<th align="center">必选</th>
<th align="left">类型</th>
<th align="left">参数说明</th>
<th align="left">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">code</td>
<td align="center">是</td>
<td align="left">string</td>
<td align="left">扫码信息</td>
<td align="left"></td>
</tr>
<tr>
<td align="left">from</td>
<td align="center">否</td>
<td align="left">string</td>
<td align="left">来源仓库</td>
<td align="left">获取指定仓库信息</td>
</tr>
</tbody>
</table>
<h5 id="_21">错误说明</h5>
<h5 id="_22">返回实例</h5>
<pre><code class="json">
    {
    &quot;c&quot;: 0,
    &quot;m&quot;: null,
    &quot;d&quot;: {
        &quot;productName&quot;: &quot;老才臣腐乳&quot;,
        &quot;productionBatch&quot;: null,
        &quot;picUrl&quot;: &quot;&quot;,
        &quot;enterpriseName&quot;: null,  //企业名称
        &quot;beginDate&quot;: &quot;2020-12-15 00:00:00&quot;,
        &quot;bundleId&quot;: &quot;6266170d-88ed-482e-ac5c-28b045bbc151&quot;, //盘符
        &quot;houseName&quot;:&quot;所在仓库名&quot;,
        &quot;status&quot;:0 ,//0 已入库 -1 已出库
        &quot;total&quot;: 2, //总数
        &quot;list&quot;: [ //列表
            &quot;001H0V247S82Y70100P7&quot;,
            &quot;001K07HV0M90AZ01KCQ8&quot;
        ]
    }
}

</code></pre>

<h4 id="12">1.2 获取产品列表信息</h4>
<h5 id="_23">接口说明</h5>
<p>产品列表信息</p>
<h5 id="_24">请求说明</h5>
<table>
<thead>
<tr>
<th align="left">http 请求方式</th>
<th align="center">get</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">url</td>
<td align="center">/trace/product/list</td>
</tr>
</tbody>
</table>
<h5 id="_25">输入参数</h5>
<table>
<thead>
<tr>
<th align="left">参数</th>
<th align="center">必选</th>
<th align="left">类型</th>
<th align="left">参数说明</th>
<th align="left">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">limit</td>
<td align="center">否</td>
<td align="left">int</td>
<td align="left">分页条数</td>
<td align="left">默认10</td>
</tr>
<tr>
<td align="left">page</td>
<td align="center">否</td>
<td align="left">int</td>
<td align="left">分页</td>
<td align="left">默认1</td>
</tr>
</tbody>
</table>
<h5 id="_26">错误说明</h5>
<h5 id="_27">返回实例</h5>
<pre><code class="json">
    {
    &quot;c&quot;: 0,
    &quot;m&quot;: null,
    &quot;d&quot;: {
        &quot;pageSize&quot;: 10,
        &quot;currentPage&quot;: 1,
        &quot;list&quot;: [
            {
                &quot;name&quot;: &quot;老才臣腐乳&quot;, //产品名称
                &quot;productId&quot;: &quot;8a2a41fa75d4301e0176643db4ab004c&quot;, //产品ID
                &quot;defaultPanSize&quot;: 50, //默认盘大小
                &quot;batchList&quot;: [
                    {
                        &quot;batchId&quot;: &quot;xxxxxxxx&quot;,  //生产批次ID
                        &quot;batchCode&quot;: &quot;20210101&quot; //批次码
                    }
                ]
            }
        ],
        &quot;end&quot;: true,
        &quot;empty&quot;: false,
        &quot;startIndex&quot;: 0,
        &quot;totalPage&quot;: null
    }
}

</code></pre>

<h4 id="13">1.3 添加批次信息</h4>
<h5 id="_28">接口说明</h5>
<p>手工添加批次信息</p>
<h5 id="_29">请求说明</h5>
<table>
<thead>
<tr>
<th align="left">http 请求方式</th>
<th align="center">post</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">url</td>
<td align="center">/trace/batch/add</td>
</tr>
</tbody>
</table>
<h5 id="_30">输入参数</h5>
<table>
<thead>
<tr>
<th align="left">参数</th>
<th align="center">必选</th>
<th align="left">类型</th>
<th align="left">参数说明</th>
<th align="left">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">productId</td>
<td align="center">是</td>
<td align="left">string</td>
<td align="left">产品ID</td>
<td align="left"></td>
</tr>
<tr>
<td align="left">batchCode</td>
<td align="center">是</td>
<td align="left">string</td>
<td align="left">生产批次</td>
<td align="left"></td>
</tr>
</tbody>
</table>
<h5 id="_31">错误说明</h5>
<h5 id="_32">返回实例</h5>
<pre><code class="json">
    {
    &quot;c&quot;: 0,
    &quot;m&quot;: null,
    &quot;d&quot;: {
        &quot;id&quot;: &quot;803a1b88-2515-4516-b1f5-d9e80d8f057c&quot; //批次ID
    }
}

</code></pre>

<h4 id="14">1.4  仓库/经销商 列表</h4>
<h5 id="_33">接口说明</h5>
<p>手工添加批次信息</p>
<h5 id="_34">请求说明</h5>
<table>
<thead>
<tr>
<th align="left">http 请求方式</th>
<th align="center">get</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">url</td>
<td align="center">/trace/house/list</td>
</tr>
</tbody>
</table>
<h5 id="_35">输入参数</h5>
<table>
<thead>
<tr>
<th align="left">参数</th>
<th align="center">必选</th>
<th align="left">类型</th>
<th align="left">参数说明</th>
<th align="left">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">type</td>
<td align="center">否</td>
<td align="left">int</td>
<td align="left">类别</td>
<td align="left">1仓库  2 经销商</td>
</tr>
<tr>
<td align="left">cityId</td>
<td align="center">否</td>
<td align="left">int</td>
<td align="left">类别</td>
<td align="left">城市ID</td>
</tr>
<tr>
<td align="left">keywords</td>
<td align="center">否</td>
<td align="left">string</td>
<td align="left">关键字</td>
<td align="left">关键字搜索</td>
</tr>
</tbody>
</table>
<h5 id="_36">错误说明</h5>
<h5 id="_37">返回实例</h5>
<pre><code class="json">
    {
    &quot;c&quot;: 0,
    &quot;m&quot;: null,
    &quot;d&quot;: [
        {
            &quot;houseId&quot;: &quot;2c984b814cb180b5014cb1a19dcf0006&quot;, //仓库ID
            &quot;houseCode&quot;: &quot;0002&quot;, //仓库编码
            &quot;houseName&quot;: &quot;测试仓库&quot;, //仓库名
            &quot;enterpriseId&quot;: &quot;8a2a41fa75d42fc50176643762630025&quot;, //所属企业
            &quot;provincesId&quot;: 10, //省份信息
            &quot;cityId&quot;: 1 //城市信息
        }
    ]
}

</code></pre>

<h4 id="141">1.4.1  城市列表</h4>
<h5 id="_38">接口说明</h5>
<p>城市列表</p>
<h5 id="_39">请求说明</h5>
<table>
<thead>
<tr>
<th align="left">http 请求方式</th>
<th align="center">get</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">url</td>
<td align="center">/trace/house/area_list</td>
</tr>
</tbody>
</table>
<h5 id="_40">输入参数</h5>
<table>
<thead>
<tr>
<th align="left">参数</th>
<th align="center">必选</th>
<th align="left">类型</th>
<th align="left">参数说明</th>
<th align="left">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">type</td>
<td align="center">否</td>
<td align="left">int</td>
<td align="left">类别</td>
<td align="left">1仓库  2 经销商</td>
</tr>
</tbody>
</table>
<h5 id="_41">错误说明</h5>
<h5 id="_42">返回实例</h5>
<pre><code class="json">
    {
    &quot;c&quot;: 0,
    &quot;m&quot;: null,
    &quot;d&quot;: [
        {
            &quot;areaid&quot;:123, //城市ID
            &quot;name&quot;:&quot;北京&quot;, //城市ID
            &quot;parentid&quot;: 3, //父节点
        }
    ]
}

</code></pre>

<h4 id="15">1.5  入库接口</h4>
<h5 id="_43">接口说明</h5>
<p>入库接口</p>
<h5 id="_44">请求说明</h5>
<table>
<thead>
<tr>
<th align="left">http 请求方式</th>
<th align="center">post</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">url</td>
<td align="center">/trace/input</td>
</tr>
</tbody>
</table>
<h5 id="_45">输入参数</h5>
<p><strong>post json协议说明</strong></p>
<pre><code class="json">
{
    &quot;actionType&quot;: 101, // 101:普通入库  102:调拨入库 103:退换货入库
    &quot;batchId&quot;: &quot;803a1b88-2515-4516-b1f5-d9e80d8f057c&quot;, //批次
    &quot;id&quot;: &quot;eae1c1e0-c17f-411f-b118-dd8cbb23c1a4&quot;, //请求ID 防止重复提交,建议uuid
    &quot;target&quot;:&quot;xxxxx&quot;,//仓库ID
    &quot;list&quot;: [{ //盘列表,可多个
        &quot;codes&quot;: [&quot;001H0V247S82Y70100P7&quot;],
        &quot;size&quot;: 1
    }],
    &quot;productId&quot;: &quot;8a2a41fa75d4301e0176643db4ab004c&quot;, //产品ID
    &quot;total&quot;: 1 //总数
}


</code></pre>

<h5 id="_46">案例</h5>
<p><strong>1.普通入库</strong></p>
<pre><code class="json">
{
    &quot;actionType&quot;: 101,
    &quot;batchId&quot;: &quot;803a1b88-2515-4516-b1f5-d9e80d8f057c&quot;,
    &quot;target&quot;:&quot;xxxxx&quot;,//仓库ID
    &quot;list&quot;: [
        {
            &quot;codes&quot;: [
                &quot;001H0V247S82Y70100P7&quot;,
                &quot;001K07HV0M90AZ01KCQ8&quot;
            ],
            &quot;size&quot;: 2
        }
    ],
    &quot;productId&quot;: &quot;8a2a41fa75d4301e0176643db4ab004c&quot;,
    &quot;total&quot;: 2
}


</code></pre>

<p><strong>2.退盘</strong></p>
<pre><code class="json">
{
    &quot;actionType&quot;: 101,
    &quot;list&quot;: [
        {
            &quot;bundleId&quot;:&quot;035e150e-81f1-4128-84e9-bcfa069ee9ed&quot;,
            &quot;action&quot;:&quot;REMOVE&quot;,
            &quot;codes&quot;: [
                &quot;001H0V247S82Y70100P7&quot;,
            ],
            &quot;size&quot;: 1
        }
    ],
    &quot;productId&quot;: &quot;8a2a41fa75d4301e0176643db4ab004c&quot;,
    &quot;total&quot;: 1
}


</code></pre>

<p><strong>3.补盘</strong></p>
<pre><code class="json">
{
    &quot;actionType&quot;: 101,
    &quot;list&quot;: [
        {
            &quot;bundleId&quot;:&quot;035e150e-81f1-4128-84e9-bcfa069ee9ed&quot;,
            &quot;action&quot;:&quot;ADD&quot;,
            &quot;codes&quot;: [
                &quot;001H0V247S82Y70100P7&quot;,
            ],
            &quot;size&quot;: 1
        }
    ],
    &quot;productId&quot;: &quot;8a2a41fa75d4301e0176643db4ab004c&quot;,
    &quot;total&quot;: 1
}


</code></pre>

<p><strong>4.调拨入库</strong></p>
<pre><code class="json">
{
    &quot;actionType&quot;: 102,
    &quot;batchId&quot;: &quot;803a1b88-2515-4516-b1f5-d9e80d8f057c&quot;,
    &quot;from&quot;:&quot;2c984b814cb180b5014cb1a19dcf0006&quot;,
    &quot;list&quot;: [
        {
            &quot;bundleId&quot;:&quot;035e150e-81f1-4128-84e9-bcfa069ee9ed&quot;,
            &quot;size&quot;: 2
        }
    ],
    &quot;productId&quot;: &quot;8a2a41fa75d4301e0176643db4ab004c&quot;,
    &quot;total&quot;: 2
}


</code></pre>

<h5 id="_47">错误说明</h5>
<h5 id="_48">返回实例</h5>
<pre><code class="json">
    {
    &quot;c&quot;: 0,
    &quot;m&quot;: null,
    &quot;d&quot;: {

    }
}

</code></pre>

<h4 id="16">1.6  出库接口</h4>
<h5 id="_49">接口说明</h5>
<p>出库接口</p>
<h5 id="_50">请求说明</h5>
<table>
<thead>
<tr>
<th align="left">http 请求方式</th>
<th align="center">post</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">url</td>
<td align="center">/trace/output</td>
</tr>
</tbody>
</table>
<h5 id="_51">输入参数</h5>
<p><strong>post json协议说明</strong></p>
<pre><code class="json">
{
    &quot;actionType&quot;: 201,
    &quot;batchId&quot;: &quot;803a1b88-2515-4516-b1f5-d9e80d8f057c&quot;,
    &quot;target&quot;:&quot;2c984b814cb180b5014cb1a19dcf0006&quot;,
    &quot;carNo&quot;:&quot;xxxx&quot;, //车牌号
    &quot;list&quot;: [
        {
            &quot;bundleId&quot;:&quot;2709daaf-aa3f-4dac-a3ae-ad23637fe52d&quot;, //盘符
            &quot;size&quot;: 1
        },
        {
            &quot;action&quot;:&quot;REMOVE&quot;,  // 退盘
            &quot;bundleId&quot;:&quot;2709daaf-aa3f-4dac-a3ae-ad23637fe52d&quot;,
            &quot;codes&quot;:[
                &quot;001H0V247S82Y70100P7&quot;
            ],
            &quot;size&quot;: 1
        }
    ],
    &quot;productId&quot;: &quot;8a2a41fa75d4301e0176643db4ab004c&quot;,
    &quot;total&quot;: 2
}


</code></pre>

<h5 id="_52">案例</h5>
<p><strong>1.普通出库</strong></p>
<pre><code class="json">
{
    &quot;actionType&quot;: 201,
    &quot;batchId&quot;: &quot;803a1b88-2515-4516-b1f5-d9e80d8f057c&quot;,
    &quot;target&quot;:&quot;2c984b814cb180b5014cb1a19dcf0006&quot;,
    &quot;carNo&quot;:&quot;xxxx&quot;, //车牌号
    &quot;list&quot;: [
        {
            &quot;bundleId&quot;:&quot;2709daaf-aa3f-4dac-a3ae-ad23637fe52d&quot;, //盘符
            &quot;size&quot;: 1
        }
    ],
    &quot;productId&quot;: &quot;8a2a41fa75d4301e0176643db4ab004c&quot;,
    &quot;total&quot;: 2
}


</code></pre>

<p><strong>2.退盘出库</strong></p>
<pre><code class="json">
{
    &quot;actionType&quot;: 201,
    &quot;batchId&quot;: &quot;803a1b88-2515-4516-b1f5-d9e80d8f057c&quot;,
    &quot;target&quot;:&quot;2c984b814cb180b5014cb1a19dcf0006&quot;, //仓库
    &quot;list&quot;: [
        {
            &quot;bundleId&quot;:&quot;2709daaf-aa3f-4dac-a3ae-ad23637fe52d&quot;, //盘符
            &quot;size&quot;: 1
        },
        {
            &quot;action&quot;:&quot;REMOVE&quot;,  // 退盘
            &quot;bundleId&quot;:&quot;2709daaf-aa3f-4dac-a3ae-ad23637fe52d&quot;,
            &quot;codes&quot;:[
                &quot;001H0V247S82Y70100P7&quot;
            ],
            &quot;size&quot;: 1
        }
    ],
    &quot;productId&quot;: &quot;8a2a41fa75d4301e0176643db4ab004c&quot;,
    &quot;total&quot;: 2
}

</code></pre>

<h5 id="_53">错误说明</h5>
<h5 id="_54">返回实例</h5>
<pre><code class="json">
    {
    &quot;c&quot;: 0,
    &quot;m&quot;: null,
    &quot;d&quot;: {

    }
}

</code></pre></div>
        </div>

        <footer class="col-md-12">
            <hr>
            <p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
        </footer>
        <script>
            var base_url = "../..",
                shortcuts = {"search": 83, "next": 78, "help": 191, "previous": 80};
        </script>
        <script src="../../js/base.js" defer></script>
        <script src="../../search/main.js" defer></script>

        <div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="Search Modal" aria-hidden="true">
    <div class="modal-dialog">
        <div class="modal-content">
            <div class="modal-header">
                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
                <h4 class="modal-title" id="exampleModalLabel">Search</h4>
            </div>
            <div class="modal-body">
                <p>
                    From here you can search these documents. Enter
                    your search terms below.
                </p>
                <form role="form">
                    <div class="form-group">
                        <input type="text" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
                    </div>
                </form>
                <div id="mkdocs-search-results"></div>
            </div>
            <div class="modal-footer">
            </div>
        </div>
    </div>
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="Keyboard Shortcuts Modal" aria-hidden="true">
    <div class="modal-dialog">
        <div class="modal-content">
            <div class="modal-header">
                <button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">&times;</span><span class="sr-only">Close</span></button>
                <h4 class="modal-title" id="exampleModalLabel">Keyboard Shortcuts</h4>
            </div>
            <div class="modal-body">
              <table class="table">
                <thead>
                  <tr>
                    <th style="width: 20%;">Keys</th>
                    <th>Action</th>
                  </tr>
                </thead>
                <tbody>
                  <tr>
                    <td class="help shortcut"><kbd>?</kbd></td>
                    <td>Open this help</td>
                  </tr>
                  <tr>
                    <td class="next shortcut"><kbd>n</kbd></td>
                    <td>Next page</td>
                  </tr>
                  <tr>
                    <td class="prev shortcut"><kbd>p</kbd></td>
                    <td>Previous page</td>
                  </tr>
                  <tr>
                    <td class="search shortcut"><kbd>s</kbd></td>
                    <td>Search</td>
                  </tr>
                </tbody>
              </table>
            </div>
            <div class="modal-footer">
            </div>
        </div>
    </div>
</div>

    </body>
</html>
